<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>set_flags</title>
    <link rel="stylesheet" href="apiReference.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB C API Reference" />
    <link rel="up" href="configuration_reference.html" title="Appendix D. DB_CONFIG Parameter Reference" />
    <link rel="prev" href="set_data_len_parameter.html" title="set_data_len" />
    <link rel="next" href="set_intermediate_dir_mode_parameter.html" title="set_intermediate_dir_mode" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 11.2.5.3</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">set_flags</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="set_data_len_parameter.html">Prev</a> </td>
          <th width="60%" align="center">Appendix D. DB_CONFIG Parameter Reference</th>
          <td width="20%" align="right"> <a accesskey="n" href="set_intermediate_dir_mode_parameter.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="set_flags_parameter"></a>set_flags</h2>
          </div>
        </div>
      </div>
      <p>
            Configures a database environment. 
            </p>
      <p>
                The syntax of the entry in the <a href="../../programmer_reference/env_db_config.html#env_db_config.DB_CONFIG" class="olink">DB_CONFIG</a> file is a single
                line with the string <code class="literal">set_flags</code>, one or
                more whitespace characters, the method flag parameter as a
                string, optionally one or more whitespace characters, and
                the string <code class="literal">on</code> or <code class="literal">off</code>.
                If the optional string is omitted, the default is
                <code class="literal">on</code>; for example, 
                <code class="literal">set_flags DB_TXN_NOSYNC</code> or 
                <code class="literal">set_flags DB_TXN_NOSYNC on</code>.  Because the
                DB_CONFIG file is read when the database environment is
                opened, it will silently overrule configuration done before
                that time.
            </p>
      <p>
            The method flag parameters are as follows:
            </p>
      <div class="itemizedlist">
        <ul type="disc">
          <li>
            DB_AUTO_COMMIT 
            <p>
            Enables/disables to automatically enclose those DB handle operations for which no explicit transaction handle was specified, and
			which modify databases in the database environment, within a transaction. 
            </p></li>
          <li>
            DB_CDB_ALLDB
            <p>Enables/disables Berkeley DB Concurrent Data Store applications to perform locking on an
			environment-wide basis rather than on a per-database basis.</p></li>
          <li>
			DB_DIRECT_DB
			<p>Enables/disables turning off system buffering of Berkeley DB database files to avoid double caching.</p></li>
          <li>
			DB_DSYNC_DB
			<p>Enables/disables configuring Berkeley DB to flush database writes to the backing disk before returning
			from the write system call, rather than flushing database writes explicitly in a separate
			system call, as necessary.</p></li>
          <li>
			DB_MULTIVERSION
			<p>Enables/disables all databases in the environment from being opened as if DB_MULTIVERSION is passed to
			the DB-&gt;open method. This flag will be ignored for queue databases for which
			DB_MULTIVERSION is not supported.</p></li>
          <li>
			DB_NOMMAP
			<p>Enables/disables Berkeley DB from copying read-only database files into the local cache instead of
			potentially mapping them into process memory.</p></li>
          <li>
			DB_REGION_INIT
			<p>Enables/disables Berkeley DB to page-fault shared regions into memory when initially creating or joining a Berkeley DB
			environment. In addition, Berkeley DB will write the shared regions when creating an
			environment, forcing the underlying virtual memory and filesystems to instantiate both
			the necessary memory and the necessary disk space.</p></li>
          <li>
			DB_TIME_NOTGRANTED
			<p>Enables/disables those database calls timing out based on lock or transaction timeout values to return
			DB_LOCK_NOTGRANTED instead of DB_LOCK_DEADLOCK. This allows applications to
			distinguish between operations which have deadlocked and operations which have exceeded
			their time limits.</p></li>
          <li>
			DB_TXN_NOSYNC
			<p>Enables/disables Berkeley DB to not write or synchronously flush the log on transaction commit.</p></li>
          <li>
			DB_TXN_NOWAIT
			<p>Enables/disables the operation to return DB_LOCK_DEADLOCK if a lock is unavailable for any Berkeley DB operation performed in the context of a
			transaction.</p></li>
          <li>
			DB_TXN_SNAPSHOT
			<p>Enables/disables all transactions in the environment to be started as if DB_TXN_SNAPSHOT were
			passed to the DB_ENV-&gt;txn_begin method, and all non-transactional cursors
			to be opened as if DB_TXN_SNAPSHOT were passed to the DB-&gt;cursor method.</p></li>
          <li>
			DB_TXN_WRITE_NOSYNC
			<p>Enables/disables Berkeley DB to write, but not synchronously flush, the log on transaction
			commit.</p></li>
          <li>
			DB_YIELDCPU
			<p>Enables/disables Berkeley DB to yield the processor immediately after each page or mutex acquisition.</p></li>
        </ul>
      </div>
      <p> For more information, see <a class="xref" href="envset_flags.html" title="DB_ENV-&gt;set_flags()">DB_ENV-&gt;set_flags()</a>.</p>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="set_data_len_parameter.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="configuration_reference.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="set_intermediate_dir_mode_parameter.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">set_data_len </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> set_intermediate_dir_mode</td>
        </tr>
      </table>
    </div>
  </body>
</html>
